home *** CD-ROM | disk | FTP | other *** search
/ APDL Eductation Resources / APDL Eductation Resources.iso / programs / keyboard / macros / !Macros / Documents / Macros < prev   
Encoding:
Text File  |  1993-04-04  |  6.5 KB  |  154 lines
  1. Macros by Paul Clifford
  2. © DoggySoft, 1993
  3.  
  4.     ____________________________________________________________________
  5.    /                                                                    \
  6. -=<                        HOW TO USE THIS PROGRAM                       >=-
  7.    \____________________________________________________________________/
  8.  
  9.  
  10. Introduction
  11. ============
  12.  
  13. Macros is a general purpose macros program, which can be used together with
  14. other program which do not offer macros. There is space for a total of
  15. twenty user definable macros, each of which can be up to 100 characters in
  16. length. The macros can be entered a variety of ways, including by hotkeys,
  17. into three different buffers, depending on your use.
  18.  
  19. You can save and load macro files for use with different programs, and once
  20. saved, can be loaded into Edit for futher modification. The program is
  21. described below in four different sections - the iconbar menu, the main
  22. menu, the main window and the iconbar icon.
  23.  
  24. Iconbar menu
  25. ============
  26.  
  27. Apart from Info and Quit, the two other options on this menu are 'Load
  28. macros' and 'Save macros' which lead off to a subwindow. Selecting 'Load
  29. macros' opens a window which you can load macro files with, by either
  30. dragging them to the arrow icon or typing in the pathname. You can load
  31. macro files that have been saved in the application directory by either
  32. using the full pathname or just the leafname, which is easier, eg. to
  33. re-load the default file, just type in 'Default' and press RETURN.
  34.  
  35. 'Save macros' leads to a subwindow where you can save the current macros by
  36. dragging the icon to a directory viewer, or just typing in a leafname to
  37. save the macros inside the application. If you save your macros inside the
  38. application as 'Default' then this will be loaded every time Macros is run
  39. from then onwards.
  40.  
  41. Main menu
  42. =========
  43.  
  44. This menu has six menu options, three of which lead to submenus. 'Speed'
  45. allows you to alter the speed at which macros are entered. Slow, Medium and
  46. Fast all enter a set number of characters each null event, but Psycho enters
  47. all the characters at once, making it very fast, but sometimes losing
  48. characters when entering macros into the keyboard buffer.
  49.  
  50. 'Output' allows you to re-direct the macros to different buffers - either
  51. the keyboard, the serial input buffer or the serial output buffer. By
  52. default, macros are sent to the keyboard buffer, but if you intend to use
  53. Macros with comms programs you might want to set it to 'Serial O', so that
  54. the macros are sent straight down the serial port.
  55.  
  56. Before explaining the third menu item, it is necessary to point out that
  57. pressing RETURN in one of the macro icons will enter a '¤' character rather
  58. than going to the next line. When entered, this character will be translated
  59. into either a carriage return or a line feed, depending on the setting of
  60. the 'New line' submenu.
  61.  
  62. 'Inside' allows you to toggle whether or not you are allowed to enter macros
  63. from one icon to another in the main Macros window. Turning it off results
  64. in a beep if you try to enter a macro into the keyboard buffer with the
  65. caret in the main window.
  66.  
  67. 'Hotkeys' lets you enter macros using ALT and function key definitions. The
  68. first 10 macros can be entered using ALT+Fx, x being the number of the
  69. macro. To enter the next ten, ALT+SHIFT+Fx is used, x being the number of
  70. the macro, minus 10.
  71.  
  72. 'Lock' is a useful option when you are entering macros into the keyboard
  73. buffer. When set, after you start entering a macro, moving the caret to
  74. another window while the macro is still being entered will stop the entry
  75. until the caret is put back. It should not be relyed totally on though,
  76. because occasionally, the odd character might manage to slip through.
  77.  
  78. 'Clear' clears all of the macro entries, allowing you to define a fresh set
  79. of macros.
  80.  
  81. Main window
  82. ===========
  83.  
  84. To the right of each macro is a button with Enter written in it. Clicking on
  85. this with SELECT attempts to enter the macro into the selected buffer, while
  86. clicking on it with ADJUST will pass the macro through OS_CLI, allowing star
  87. commands to be executed. If 'Serial I' or 'Serial O' are selected, macros
  88. can also be entered by putting the caret in the icon and pressing the INSERT
  89. key.
  90.  
  91. When being entered, macros are first passed through OS_GSTrans, allowing for
  92. the inclusion of control comands, system variables etc.. Details on this
  93. format can be found on page 451 of the Risc OS 2 user guide or page 147 of
  94. the Risc OS 3 user guide.
  95.  
  96. Iconbar icon
  97. ============
  98.  
  99. Clicking SELECT or ADJUST on this performs the normal action of opening the
  100. main window at the front of the window stack. However, dragging a text file
  101. here will enter its contents into the chosen buffer. The speeds chosen on
  102. the 'Speed' menu apply here, with one slight difference. 'Psycho' no longer
  103. enters the whole lot before returning control to the machine, as with long
  104. textfiles this could hog the machine for quite a while. Despite this, it is
  105. still marginally faster than the other options.
  106.  
  107.     ____________________________________________________________________
  108.    /                                                                    \
  109. -=<                              CONDITIONS                              >=-
  110.    \____________________________________________________________________/
  111.  
  112.  
  113. If you find this program useful, I would appreciate a small (or large!)
  114. donation, although this is not obligatory.
  115.  
  116. Macros may be distributed freely on the following conditions:
  117.  
  118.   1) No more than £2.00 is charged for a disc containing it, unless
  119.      permission is obtained from me.
  120.   2) Any modifications are sent to me so I can keep track of the current
  121.      version number.
  122.   3) All the files are included, unchanged, except 'Resources.Macros' which
  123.      may be deleted if you wish.
  124.   4) You do not claim to have written Macros yourself.
  125.   5) You don't phone me for anything (write to me, contact DoggySoft, or
  126.      send a message via Arcade), as the person answering would most likely
  127.      not be me, and think you mad.
  128.  
  129.     ____________________________________________________________________
  130.    /                                                                    \
  131. -=<                          HOW TO CONTACT ME                           >=-
  132.    \____________________________________________________________________/
  133.  
  134.  
  135. My address (phone number deliberately missing!):
  136.  
  137.   Paul Clifford,
  138.   3 St Anthonys Avenue,
  139.   Woodford Green,
  140.   Essex,
  141.   IG8 7EP,
  142.   England.
  143.  
  144.   Or ring Arcade BBS (081-654-2212) and mail me as user #168
  145.  
  146. DoggySoft (and Jp's) address:
  147.  
  148.   DoggySoft Consumer Department,
  149.   Furzefield House,
  150.   Furzefield Road,
  151.   Beaconsfield,
  152.   Bucks, HP9 1PQ. 
  153.  
  154.   Or ring 0494-673222